home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / smsrch3.zip / SMSRCH.DOC next >
Text File  |  1991-10-21  |  6KB  |  237 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.            *** Sarah Marketing - STRING SEARCH - Version 1.01 ***
  10.  
  11.  
  12.            SMSRCH Features
  13.            ---------------
  14.            Feature wise,  SMSRCH has more  practical value than  most search
  15.            routines  on the market.  It's ideal for general search functions
  16.            and excellent for variable searching during program debugging.  
  17.  
  18.            SMSRCH  allows searching of  up to 100  strings in one  pass.  It
  19.            allows case sensitive searches as well as ignoring case.  You can
  20.            specify  whether   to  search   for  "words  only"   or  embedded
  21.            strings--for each  string independently.  And,  especially useful
  22.            for programmers,  it allows  you to  ignore lines beginning  with
  23.            certain strings (program comment lines, for example).  
  24.  
  25.  
  26.  
  27.            SMSRCH Registration
  28.            -------------------
  29.            Unregistered copies of SMSRCH will only search for a maximum of 4
  30.            characters per search  string.  Registered copies will  search up
  31.            to 80 characters per search string.  
  32.  
  33.            To Register send $25 to:
  34.  
  35.            Sarah Marketing
  36.            1582 - 51 Street
  37.            Brooklyn, New York 11219
  38.  
  39.            Be sure to specify disk size: 3 1/2 - 720K  or  5 1/4 360K  
  40.  
  41.  
  42.  
  43.            SMSRCH Documentation
  44.            --------------------
  45.            Assume you have the following files on disk:
  46.  
  47.  
  48.            FILE1.TXT containing ... 
  49.            ---------
  50.            They fight like cats and dogs.  
  51.            But the cat always wins.
  52.            And the dog never wins.  
  53.  
  54.  
  55.            FILE2.TXT containing ... 
  56.            ---------
  57.            Crawls like a caterpillar.  
  58.            Slow as a snail. 
  59.  
  60.                                            1
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.            FILE3.TXT containing ... 
  68.            ---------
  69.            It's a dog eat dog world. 
  70.            But not if you're a big dog. 
  71.  
  72.  
  73.            Input Files
  74.            -----------
  75.            SMSRCH requires that you  create a file called SMSRCH.INP  with a
  76.            list of  all the files you  want to search through.   (You can do
  77.            this with an editor or  word processor.  Or, for long  lists, you
  78.            can create SMSRCH.INP with the DIR command with redirection, then
  79.            edit  SMSRCH.INP  to take  out all  extraneous  data.)   So, file
  80.            SMSRCH.INP, in this case, will contain ... 
  81.  
  82.            FILE1.TXT
  83.            FILE2.TXT
  84.            FILE3.TXT
  85.  
  86.  
  87.            In  the  following  example  'PROMPT>'  indicates  the  program's
  88.            prompt.   'RESP>' indicates your  response.   Anything in  square
  89.            brackets is  explanation for documentation purposes.   <cr> means
  90.            hit carriage return.  
  91.  
  92.  
  93.            After  creating  input  file  SMSRCH.INP,  start  the  search  by
  94.            entering ... 
  95.  
  96.            SMSRCH<cr>
  97.  
  98.            PROMPT>Search for EXACT matches? (E)  Or ignore case? (<cr>) ...
  99.  
  100.            [You  may enter  an 'E' if  you want a  case-sensitive search, or
  101.            carriage return if you want  the case ignored.  For now,  we just
  102.            hit <cr>.]
  103.  
  104.            PROMPT>Enter search string    1 (80 character max / <cr>  to end)
  105.            ...
  106.            RESP>cat
  107.            PROMPT>   ... Is the above string a WORD? (W)
  108.                          Or an embedded string?      (<cr>) ... RESP>w
  109.  
  110.            [If you want 'cat' found only if it's a separate word, enter 'W'.
  111.            If you don't care if it's part of another word, hit <cr>.]
  112.  
  113.            PROMPT>Enter search string    2 (80 character max / <cr>  to end)
  114.            ...
  115.            RESP>dog
  116.            PROMPT>   ... Is the above string a WORD? (W)
  117.                          Or an embedded string?      (<cr>) ...  RESP> <cr>
  118.  
  119.                                            2
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.            PROMPT>Enter search string    3 (80 character max  / <cr> to end)
  127.            ...
  128.  
  129.            [As long as you keep entering search strings you will continue to
  130.            be  prompted for  more, up to  100 times.   Hitting  <cr> without
  131.            entering a string  will move you  on to the next  step.  In  this
  132.            case, we hit <cr>.]
  133.  
  134.  
  135.            PROMPT>AND search strings? (A)   Or OR search strings? (<cr>) ...
  136.                                                                   RESP> <cr>
  137.  
  138.            [If you  want to  find only  lines that  contain all your  search
  139.            strings  on the same  line, enter 'A'.   If you want  to find any
  140.            line that contains any one of your search strings, enter <cr>.]
  141.  
  142.            PROMPT>Do not search lines beginning with ... RESP>but <cr>
  143.  
  144.            [The search  will not be performed  on lines that begin  with the
  145.            string entered here.  <cr> without a  string will cause all lines
  146.            to  be searched.   In this  case, we  don't want  to search lines
  147.            beginning with 'but'.] 
  148.  
  149.  
  150.            The search begins, and you will see the following on the screen:
  151.  
  152.            --- FILE: FILE1.TXT
  153.            --- FILE: FILE2.TXT
  154.            --- FILE: FILE3.TXT
  155.            - EOJ -
  156.  
  157.  
  158.  
  159.            The  results of  the  search  are  contained  in  a  file  called
  160.            SMSRCH.OUT.  For this example, SMSRCH.OUT will look like this:
  161.  
  162.             * String search, ignoring case.
  163.             * Ignored lines beginning with ... 
  164.             ->BUT<-
  165.  
  166.                 The following strings have been ORed :
  167.                 --------------------------------------
  168.             W ->CAT<-
  169.               ->DOG<-
  170.                 --------------------------------------
  171.  
  172.             --- FILE: FILE1.TXT   
  173.                1>They fight like cats and dogs.
  174.                3>And the dog never wins.
  175.             --- FILE: FILE2.TXT   
  176.             --- FILE: FILE3.TXT   
  177.  
  178.                                            3
  179.  
  180.  
  181.  
  182.  
  183.  
  184.                1>It's a dog eat dog world.
  185.             - EOJ -
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.                                            4